home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XAddHost.z / XAddHost
Encoding:
Text File  |  2002-10-03  |  8.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXAAAAddddddddHHHHoooosssstttt((((3333XXXX11111111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))      XXXXAAAAddddddddHHHHoooosssstttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemoveHosts,
  10.           XSetAccessControl, XEnableAccessControl,
  11.           XDisableAccessControl, XHostAddress - control host access
  12.           and host control structure
  13.  
  14.      SSSSYYYYNNNNTTTTAAAAXXXX
  15.           XAddHost(_d_i_s_p_l_a_y, _h_o_s_t)
  16.                 Display *_d_i_s_p_l_a_y;
  17.                 XHostAddress *_h_o_s_t;
  18.  
  19.           XAddHosts(_d_i_s_p_l_a_y, _h_o_s_t_s, _n_u_m__h_o_s_t_s)
  20.                 Display *_d_i_s_p_l_a_y;
  21.                 XHostAddress *_h_o_s_t_s;
  22.                 int _n_u_m__h_o_s_t_s;
  23.  
  24.           XHostAddress *XListHosts(_d_i_s_p_l_a_y, _n_h_o_s_t_s__r_e_t_u_r_n,
  25.           _s_t_a_t_e__r_e_t_u_r_n)
  26.                 Display *_d_i_s_p_l_a_y;
  27.                 int *_n_h_o_s_t_s__r_e_t_u_r_n;
  28.                 Bool *_s_t_a_t_e__r_e_t_u_r_n;
  29.  
  30.           XRemoveHost(_d_i_s_p_l_a_y, _h_o_s_t)
  31.                 Display *_d_i_s_p_l_a_y;
  32.                 XHostAddress *_h_o_s_t;
  33.  
  34.           XRemoveHosts(_d_i_s_p_l_a_y, _h_o_s_t_s, _n_u_m__h_o_s_t_s)
  35.                 Display *_d_i_s_p_l_a_y;
  36.                 XHostAddress *_h_o_s_t_s;
  37.                 int _n_u_m__h_o_s_t_s;
  38.  
  39.           XSetAccessControl(_d_i_s_p_l_a_y, _m_o_d_e)
  40.                 Display *_d_i_s_p_l_a_y;
  41.                 int _m_o_d_e;
  42.  
  43.           XEnableAccessControl(_d_i_s_p_l_a_y)
  44.                 Display *_d_i_s_p_l_a_y;
  45.  
  46.           XDisableAccessControl(_d_i_s_p_l_a_y)
  47.                 Display *_d_i_s_p_l_a_y;
  48.  
  49.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  50.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  51.  
  52.           _h_o_s_t      Specifies the host that is to be added or removed.
  53.  
  54.           _h_o_s_t_s     Specifies each host that is to be added or
  55.                     removed.
  56.  
  57.           _m_o_d_e      Specifies the mode.  You can pass _E_n_a_b_l_e_A_c_c_e_s_s or
  58.                     _D_i_s_a_b_l_e_A_c_c_e_s_s.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXAAAAddddddddHHHHoooosssstttt((((3333XXXX11111111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))      XXXXAAAAddddddddHHHHoooosssstttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _n_h_o_s_t_s__r_e_t_u_r_n
  75.                     Returns the number of hosts currently in the
  76.                     access control list.
  77.  
  78.           _n_u_m__h_o_s_t_s Specifies the number of hosts.
  79.  
  80.           _s_t_a_t_e__r_e_t_u_r_n
  81.                     Returns the state of the access control.
  82.  
  83.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  84.           The _X_A_d_d_H_o_s_t function adds the specified host to the access
  85.           control list for that display.  The server must be on the
  86.           same host as the client issuing the command, or a _B_a_d_A_c_c_e_s_s
  87.           error results.
  88.  
  89.           _X_A_d_d_H_o_s_t can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  90.  
  91.           The _X_A_d_d_H_o_s_t_s function adds each specified host to the
  92.           access control list for that display.  The server must be on
  93.           the same host as the client issuing the command, or a
  94.           _B_a_d_A_c_c_e_s_s error results.
  95.  
  96.           _X_A_d_d_H_o_s_t_s can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  97.  
  98.           The _X_L_i_s_t_H_o_s_t_s function returns the current access control
  99.           list as well as whether the use of the list at connection
  100.           setup was enabled or disabled.  _X_L_i_s_t_H_o_s_t_s allows a program
  101.           to find out what machines can make connections.  It also
  102.           returns a pointer to a list of host structures that were
  103.           allocated by the function. When no longer needed, this
  104.           memory should be freed by calling _X_F_r_e_e.
  105.  
  106.           The _X_R_e_m_o_v_e_H_o_s_t function removes the specified host from the
  107.           access control list for that display.  The server must be on
  108.           the same host as the client process, or a _B_a_d_A_c_c_e_s_s error
  109.           results.  If you remove your machine from the access list,
  110.           you can no longer connect to that server, and this operation
  111.           cannot be reversed unless you reset the server.
  112.  
  113.           _X_R_e_m_o_v_e_H_o_s_t can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  114.  
  115.           The _X_R_e_m_o_v_e_H_o_s_t_s function removes each specified host from
  116.           the access control list for that display. The X server must
  117.           be on the same host as the client process, or a _B_a_d_A_c_c_e_s_s
  118.           error results.  If you remove your machine from the access
  119.           list, you can no longer connect to that server, and this
  120.           operation cannot be reversed unless you reset the server.
  121.  
  122.           _X_R_e_m_o_v_e_H_o_s_t_s can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  123.  
  124.           The _X_S_e_t_A_c_c_e_s_s_C_o_n_t_r_o_l function either enables or disables
  125.           the use of the access control list at each connection setup.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXAAAAddddddddHHHHoooosssstttt((((3333XXXX11111111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))      XXXXAAAAddddddddHHHHoooosssstttt((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           _X_S_e_t_A_c_c_e_s_s_C_o_n_t_r_o_l can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e
  141.           errors.
  142.  
  143.           The _X_E_n_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l function enables the use of the
  144.           access control list at each connection setup.
  145.  
  146.           _X_E_n_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l can generate a _B_a_d_A_c_c_e_s_s error.
  147.  
  148.           The _X_D_i_s_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l function disables the use of the
  149.           access control list at each connection setup.
  150.  
  151.           _X_D_i_s_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l can generate a _B_a_d_A_c_c_e_s_s error.
  152.  
  153.      SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEESSSS
  154.           The _X_H_o_s_t_A_d_d_r_e_s_s structure contains:
  155.  
  156.           typedef struct {
  157.                int family;              /* for example FamilyInternet */
  158.                int length;              /* length of address, in bytes */
  159.                char *address;           /* pointer to where to find the address */
  160.           } XHostAddress;
  161.  
  162.           The family member specifies which protocol address family to
  163.           use (for example, TCP/IP or DECnet) and can be
  164.           _F_a_m_i_l_y_I_n_t_e_r_n_e_t, _F_a_m_i_l_y_D_E_C_n_e_t, or _F_a_m_i_l_y_C_h_a_o_s.  The length
  165.           member specifies the length of the address in bytes.  The
  166.           address member specifies a pointer to the address.
  167.  
  168.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  169.           _B_a_d_A_c_c_e_s_s A client attempted to modify the access control
  170.                     list from other than the local (or otherwise
  171.                     authorized) host.
  172.  
  173.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  174.                     values accepted by the request.  Unless a specific
  175.                     range is specified for an argument, the full range
  176.                     defined by the argument's type is accepted.  Any
  177.                     argument defined as a set of alternatives can
  178.                     generate this error.
  179.  
  180.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  181.           XFree(3X11)
  182.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.